home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Workbench Add-On
/
Workbench Add-On - Volume 1.iso
/
BBS-Archive
/
Util
/
Time
/
MonkeyClock.lha
/
MonkeyClockV1.1
/
MonkeyClock.doc
< prev
next >
Wrap
Text File
|
1994-12-06
|
9KB
|
293 lines
+--------------------------------------+
| |
| Welcome to MonkeyClock_v1.1 ! |
| ----------------------------- |
| |
| |
| (Nov-21-1994) |
+--------------------------------------+
[0] Index:
----------
[0] This lines
[1] Introduction
[2] Installation
[3] Customization
[4] Copyrights and E-Mail-ware
[5] Disclaimer
[1] Introduction
----------------
MonkeyClock is a simple MUI + WB clock which has some powerful
customization options.
It is an E-Mail-ware program; read section [4] for further details.
Please read carefully MUI.readme and MUIBuilder.readme files, too.
To run MonkeyClock you need OS 2.0 (or higher) and muimaster.library
(you can find it in MUI user-package).
[2] Installation
----------------
You can simply double-click on Install-MonkeyClock icon (you don't
need installer, because it is only a shell script).
If you want to do it by hand follow these steps:
- copy "monkey.config" file to S:
- copy "display.font" file and display directory (with its contents)
to FONTS: if you want to use this font with MonkeyClock.
- copy MonkeyClock and its icon to WBStartup: (or elsewhere)
NOTE: if you use Install-MonkeyClock, MonkeyClock program will be
copied in SYS:WBStartup/ directory so it will be run every
time you turn on your Amiga.
[3] Customization
-----------------
MonkeyClock has a configuration file ("monkey.config"), which should be
placed in directory "S:"; this file contains informations about fonts,
date and time formats, and alarm set-up.
FONTS
-----
MonkeyClock uses two different fonts for displaying hour and date; they
are specified in the two lines of configuration file:
CLOCK_FONT: "<font name with full path>" , <font size>
DATE_FONT: "<font name with full path>" , <font size>
For example, if you want the hour to be displayed using font Times and
size 11, you must add the following line in S:monkey.config
CLOCK_FONT: "FONTS:Times.font" , 11
* NOTE: if you want to CONTROL MonkeyClock FONTS WITH MUI, YOU MUST DELETE
THE TWO FONT LINES IN monkey.config: in this way, MonkeyClock uses MUI
font "Tiny" for date and MUI font "Fixed" for hour.
The MonkeyClock archive contains a nice font, which looks great when used
to display hour in a high res laced screen; see installation section for
further details.
HOUR AND DATE FORMATS
---------------------
The best feature of MonkeyClock is that you can fully redefine what
it displays: you can set a clock that shows only the seconds, you can
add the name of your time-zone to the date, you can display the name
of your girl friend :?) between the day of the week and the year and so
on ...
All these things can be easily achived selecting Format from MonkeyClock
menu: a new window will appear.
In this window you can change the hour and date format strings (labeled
'Time Fmt:' and 'Date Fmt:' ) which control what the clock displays.
You can use some special sequences of characters (a '%' followed by
a letter) which have special meanings:
SEQUENCE MEANING
%a day of the week (abbreviation)
%A day of the week ('Sunday', 'Monday', ...)
%b month's name (abbreviation)
%B month's name ('Genuary', 'February', ...)
%c local date and hour
%d day oh the month (01-31)
%H hour (00-23)
%I hour (01-12)
%j day of the year
%m month (01-12)
%M minutes
%p AM or PM (localized, i.e. local initials)
%S seconds
%U week of the year (00-53) (week begins on Sunday)
%w day of the week (0-6)
%W week of the year (00-53) (week begins on Monday)
%x local date representation
%X local hour representation
%y year (00-99)
%Y year with century
%Z time zone name (if there is one)
%% %
For example, if you want a clock which displays the message 'hello world'
between seconds and minutes, and only the year (with century) as date,
you must set the two strings as follow:
+-------------------+
Time Fmt: |%S Hello World %M |
+-------------------+
+-------------------+
Date Fmt: |%Y |
+-------------------+
In Format window you'll find some buttons, too:
Use : apply changes to MonkeyClock
---
Default : set default time and date formats
-------
Cancel : discard changes in format strings
------
Load : load time and date formats from monkey.config
----
Save : save time and date formats to monkey.config
----
(when MonkeyClock is started, it reads time and date formats from
monkey.config configuration file).
ALARM
-----
MonkeyClock loses nothing in comparison with your favourite alarm-clock:
select Alarm from MonkeyClock menu and the Set-Alarm window will appear.
Use Hours and Minutes sliders to set the alarm-time, and click on
button [Alarm ON] to turn the alarm ON or OFF.
You can also change the alarm-message that will be displayed in
the alarm-window.
In Set-Alarm window you'll find these buttons:
Use : use current alarm settings
---
Save : save current alarm settings to monkey.config
----
Cancel : discard current alarm settings
------
(when MonkeyClock is started, it reads alarm settings from monkey.config
configuration file).
When MonkeyClock notices that it's time to wake you up 8-|, it makes a
standard intuition screen-flash + beep and pop-ups a window with the
alert message; when you close this window, the alarm is automatically
turned off.
WINDOW POSITION AND MUI-SETTINGS
--------------------------------
If you don't have already registered your MUI package, your MUI
preferences program probably will not save your MUI settings (you
can save 'em only as global settings).
So, if you have some trouble with MonkeyClock window position and
size try this:
- drag and resize MonkeyClock until you find a good position in
your WB window, then double-click FixSize&Pos icon
- when you turn on your Amiga, MonkeyClock will open
its window in your favourite position
[4] Copyrights and E-Mail-ware
MonkeyClock (v1.1) comes in the lharc archive MonkeyClock_v1.1.lha
which holds the following files:
MonkeyClock > the executable
MonkeyClock.info > a nice icon for MonkeyClock
MonkeyClock.doc > this text-file
MUI.readme > something about MUI
MUIBuilder.readme > something about MUIBuilder
Install_MonkeyClock > the installation script
FixSize&Pos > fix MonkeyClock position and size
monkey.config > the configuration file
display.font > a nice font for MonkeyClock
display/26 >
plus some other .info files
MonkeyClock is FREEWARE: the archive MonkeyClock_1.1.lha MAY BE FREELY
DISTRIBUTED, as long as no charges more than reasonable copying and
handling fees are collected!!!
You cannot modify (or leave out) none of its files and the display font
cannot be distributed outside the MonkeyClock package.
This program may be included in freeware collections, providing that the
previous conditions are respected.
>> TO SOFTWARE REVIEWS: if you include this program in one of your
disks, please send me a copy of the review, thanks :-)
>> MonkeyClock is also E-Mail-ware:
--------------------------------
if you decide to install it, please send me an email to give me some
ideas or remarks ... if you find some BUGS, send me an email ...
if you hate it, send me an email, too ... (-B
My address:
+--------------------------------------+
| |
| De Biasi Marzio |
| via Borgo Simoi, 34 |
| 31029 Vittorio Veneto (TV) |
| Italy |
| |
| E-Mail: debiasi@dimi.uniud.it |
| |
+--------------------------------------+
Thanks!!!
[5] Disclaimer
--------------
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.